home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / datab.z / datab
Encoding:
Text File  |  2002-10-03  |  4.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ddddaaaattttaaaabbbb((((DDDD4444))))                                                            ddddaaaattttaaaabbbb((((DDDD4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _dddd_aaaa_tttt_aaaa_bbbb - STREAMS data block structure
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _dddd_aaaa_tttt_aaaa_bbbb structure describes the data of a STREAMS message.
  18.  
  19. UUUUSSSSAAAAGGGGEEEE
  20.      The actual data contained in a STREAMS message is stored in a data buffer
  21.      pointed to by this structure.  A message block structure [_mmmm_ssss_gggg_bbbb(D4)]
  22.      includes a field that points to a _dddd_aaaa_tttt_aaaa_bbbb structure.
  23.  
  24.      A data block can have more than one message block pointing to it at one
  25.      time, so the _dddd_bbbb______rrrr_eeee_ffff member keeps track of a data block's references,
  26.      preventing it from being deallocated until all message blocks are
  27.      finished with it.
  28.  
  29.    SSSSttttrrrruuuuccccttttuuuurrrreeee DDDDeeeeffffiiiinnnniiiittttiiiioooonnnnssss
  30.      The _dddd_aaaa_tttt_aaaa_bbbb structure is defined as type _dddd_bbbb_llll_kkkk______tttt and contains the following
  31.      members:
  32.      _uuuu_cccc_hhhh_aaaa_rrrr______tttt   _****_dddd_bbbb______bbbb_aaaa_ssss_eeee_;;;;   _////_**** _ffff_iiii_rrrr_ssss_tttt _bbbb_yyyy_tttt_eeee _oooo_ffff _bbbb_uuuu_ffff_ffff_eeee_rrrr _****_////
  33.      _uuuu_cccc_hhhh_aaaa_rrrr______tttt   _****_dddd_bbbb______llll_iiii_mmmm_;;;;    _////_**** _llll_aaaa_ssss_tttt _bbbb_yyyy_tttt_eeee _((((_++++_1111_)))) _oooo_ffff _bbbb_uuuu_ffff_ffff_eeee_rrrr _****_////
  34.      _uuuu_cccc_hhhh_aaaa_rrrr______tttt   _dddd_bbbb______rrrr_eeee_ffff_;;;;     _////_**** _#### _oooo_ffff _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee _pppp_oooo_iiii_nnnn_tttt_eeee_rrrr_ssss _tttt_oooo _tttt_hhhh_iiii_ssss _dddd_aaaa_tttt_aaaa _****_////
  35.      _uuuu_cccc_hhhh_aaaa_rrrr______tttt   _dddd_bbbb______tttt_yyyy_pppp_eeee_;;;;    _////_**** _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee _tttt_yyyy_pppp_eeee _****_////
  36.      The _dddd_bbbb______bbbb_aaaa_ssss_eeee field points to the beginning of the data buffer.  Drivers
  37.      and modules should not change this field.
  38.  
  39.      The _dddd_bbbb______llll_iiii_mmmm field points to one byte past the end of the data buffer.
  40.      Drivers and modules should not change this field.
  41.  
  42.      The _dddd_bbbb______rrrr_eeee_ffff field contains a count of the number of message blocks sharing
  43.      the data buffer.  If it is greater than 1, drivers and modules should not
  44.      change the contents of the data buffer.  Drivers and modules should not
  45.      change this field.
  46.  
  47.      The _dddd_bbbb______tttt_yyyy_pppp_eeee field contains the message type associated with the data
  48.      buffer.  This field can be changed by the driver.  However, if the _dddd_bbbb______rrrr_eeee_ffff
  49.      field is greater than 1, this field should not be changed.
  50.  
  51. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  52.      _ffff_rrrr_eeee_eeee______rrrr_tttt_nnnn(D4), _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee_ssss(D5), _mmmm_ssss_gggg_bbbb(D4)
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.